home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Franz PD / Franz PD Disk #279 (1993)(Rhein-Sieg-Soft).zip / Franz PD Disk #279 (1993)(Rhein-Sieg-Soft).adf / ak_gen0-lib_V38.20.LHA / ak_gen0-library / AK_GEN0-Lib_ENG.doc < prev    next >
Text File  |  1993-10-17  |  8KB  |  282 lines
  1.  
  2.               ak_gen0.library V38.20
  3.  
  4.                - FREEWARE -
  5.  
  6.          © 1989-93 by Andreas R. Kleinert. All rights reserved.
  7.  
  8.           This program was written under OS V3.00 and is therefore
  9.           fully compatible. It needs OS >= V1.2.
  10.  
  11.           Next generation of the "ak.library".
  12.  
  13.           Release Date : 17.10.1993
  14.  
  15.  
  16.     Copyright :
  17.     ===========
  18.  
  19.     The program ak_gen0.library V38.20 and its documentation files are
  20.     (C)opyright 1989-93 by Andreas R. Kleinert. All rights reserved.
  21.  
  22.     The "ak_gen0.library" may be used for own program projects, if those
  23.     are PUBLIC DOMAIN or FREEWARE.
  24.  
  25.     Programmers of SHAREWARE, which charge a share-fee higher than 20,-DM
  26.     (or $15), or programmers of commercial programs have to get the explicite
  27.     permission of the author (me) to use the library. Contact me to get
  28.     informed about my conditions.
  29.  
  30.  
  31.     Disclaimer :
  32.     ============
  33.  
  34.     The author takes no responsibility for any results of the use of this
  35.     program.
  36.     This software is provided "AS IS" and there is no warranty of any kind,
  37.     so that you use this software at your own risk.
  38.  
  39.  
  40.     Distribution :
  41.     ==============
  42.  
  43.     The program ak_gen0.library V38.20 is freely distributable (FREEWARE).
  44.     You may copy it, if the copyright notice is left intact and
  45.     all of its parts are included in the distribution.
  46.     This program must not be included in commercial packages or commercial
  47.     program collections without my written permission.
  48.     This program must not be sold in any way, but it is allowed to take
  49.     a nominal fee including the costs for copying.
  50.  
  51.     This program may be put on public domain disks or included in public
  52.     domain disk libraries.
  53.     Special permission hereby goes to Fred Fish's AmigaLib-Disks and
  54.     the german series TAIFUN, FRANZ, TIME, GPD and Amiga Szene.
  55.  
  56.     This program may also be distributed via electronic mail and may be
  57.     put into mailboxes as long as the redistribution conditions are
  58.     respected in all points.
  59.  
  60.     By using or distributing this program you automatically agree to
  61.     all of the above conditions and terms.
  62.  
  63.  
  64.     Functions :
  65.     ===========
  66.  
  67.     The "ak_gen0.library" is used in many of my programs and it consists of
  68.     many functions, which make programming much easier (e.g. the programming
  69.     of "Intuition").
  70.  
  71.  
  72.     Installation :
  73.     ==============
  74.  
  75.     Just copy the "ak_gen0.library" into your "LIBS:"-directory.
  76.  
  77.  
  78.     Usage :
  79.     =======
  80.  
  81.     The "ak_gen0.library" uses STACK-Parameters and therefore cannot be
  82.     used with AmigaBASIC. It has been developed for SAS/C and compatible
  83.     Programming Languages.
  84.  
  85.     The "ak_gen0.library" consists of ...
  86.  
  87.      - Functions for comfortable opening of Windows and Screens
  88.      - Functions for simple creation of Gadgets, Menus, Submenus, etc.
  89.      - Functions for simple print-out of Texts
  90.      - an easy to handle FileRequester, which is completely managed by the
  91.        Library
  92.        (under OS V2.04+ the FileRequester of the "asl.library" is called
  93.        instead)
  94.      - an easy to handle ScreenMode-Requester, which is completely managed
  95.        by the Library
  96.        (under OS V2.1+ the ScreenModeRequester of the "asl.library" is called
  97.        instead)
  98.      - a random-number generator
  99.      - Functions to wait for special events as "Left Mousebutton pressed"
  100.        or "Key ??? pressed"
  101.      - etc.
  102.  
  103.     Read the file "AK_GEN0-Lib_Reference.doc", to get a full description of
  104.     its functions.
  105.  
  106.     Note : The "ak_gen0.library" makes use of some of Exec's "Lists&Nodes"-
  107.        functions. If your OS-Version is "buggy" inside these, try
  108.        to use "SetPatch Vx.xx".
  109.  
  110.  
  111.     Correspondence :
  112.     ================
  113.  
  114.     If you like, you may send me some money. Perhaps this will motivate me
  115.     to continue programming such programs or just making updates of
  116.     this one. Send bug-reports, money or whatever to :
  117.  
  118.        Andreas R. Kleinert,
  119.        Grube Hohe Grethe 23,
  120.        D-57074 Siegen,
  121.        Germany.              email : ...
  122.  
  123.  
  124.     History :
  125.     =========
  126.  
  127.      V38.20 :
  128.      -------
  129.  
  130.       - added support for ASL-ScreenMode-Requester (OS V2.1+/V38+)
  131.       - fixed some small bugs and improved some small things
  132.       - Includes changes
  133.       - use of SAS/C V6.3
  134.       - Programmers Note : Increase your specific ak_gen0.library minimum to
  135.     V38. Versions equal or smaller than V37 should no longer be used.
  136.  
  137.  
  138.      V38.1 :
  139.      -------
  140.  
  141.       - "code-splitting"
  142.       - "new look" for Prop-Gadgets under Intuition V37+
  143.       - fixed Mode-Names under OS 1.3 :
  144.  
  145.     Lores [Interlace] -> LowRes [Interlace]
  146.     Hires [Interlace] -> HighRes [Interlace]
  147.  
  148.       - ModeRequester now also recognizes PAL and NTSC under
  149.     OS 1.3
  150.       - new Default-Flag (AKBase) for the ModeRequester :
  151.     Use of the "real" MaxOverScan-Values (-1*MinX + MaxX, ...)
  152.     as Maximum Values for Width and Height.
  153.     Example :
  154.           HighRes 724x283 instead
  155.                of 652x268
  156.  
  157.       - the Function "AK_ReadDir()" (OBSOLETE) now internally uses
  158.     also "AK_GetDirList()" / "AK_FreeDirList()", while
  159.     value -1 is returned if an error occurs.
  160.     This should be compatible, because anyway there's only the
  161.     following possible way to read the data
  162.  
  163.      for(i=0; i<=count; i++) printf("%s (%ld)", direntry[i], dirtype[i]);
  164.  
  165.     from the structures.
  166.  
  167.      - four new functions for memory management :
  168.  
  169.        - AK_GetMemList
  170.  
  171.      allocates list for memeory management
  172.  
  173.        - AK_FreeMemList
  174.  
  175.      allocates list for memeory management and memory entries
  176.  
  177.        - AK_AddMemEntry
  178.  
  179.      adds an entry to the list
  180.      (if not possible, memory will be delocated)
  181.  
  182.        - AK_AllocMemEntry
  183.  
  184.      allocates memory and adds an entry to the list
  185.  
  186.  
  187.      V37.95 :
  188.      --------
  189.  
  190.       - Requester now also can be controlled via keyboard :
  191.  
  192.     - internal FileRequester (only for OS V1.3, not with ASL) :
  193.  
  194.        ESC      : Cancel
  195.        P      : Parent
  196.        A      : Assigns
  197.        1..8   : Select Entry
  198.        Return : Confirm
  199.  
  200.     - ModeRequester :
  201.  
  202.        ESC      : Cancel
  203.        1..8   : Select Entry
  204.        Return : Confirm
  205.  
  206.  
  207.      V37.89 :
  208.      --------
  209.  
  210.       - Requester-Type was not set, so memory was not delocated
  211.       - completely new memory management for the Requesters
  212.     (new, yet internal Routines)
  213.       - optimizations inside the Requesters
  214.       - Propgadget-Structures now 100% local
  215.       - bug in ModeRequester (undefined entries) fixed
  216.  
  217.  
  218.      V37.87 - V37.88 :
  219.      -----------------
  220.  
  221.       - AK_AutoRequester() modificated
  222.       - Propgadget-Structures now local/static
  223.  
  224.  
  225.      V37.85 - V37.86 :
  226.      -----------------
  227.  
  228.      - little bug-fixes
  229.      - smaller Code-Size
  230.      - corrected Documentation
  231.  
  232.  
  233.      V37.83 :
  234.      --------
  235.  
  236.      - major update
  237.      - five new functions :
  238.  
  239.        - AK_GetDirList
  240.  
  241.      allocates list for Directory-Content and fills it
  242.  
  243.        - AK_FreeDirList
  244.  
  245.      delocates List with Directory-Content
  246.  
  247.        - AK_GetModeList
  248.  
  249.      allocates list for Screen-Modes and fills it
  250.  
  251.        - AK_FreeModeList
  252.  
  253.      delocates List with Screen-Modes
  254.  
  255.        - AK_ModeRequest
  256.  
  257.      NEW : SCREEN-MODE-REQUESTER !!!
  258.  
  259.      - Use of SAS/C V6.00 :
  260.     - better Code (less bytes)
  261.     - Include-Files now with "tagcall" Pragmas
  262.       (Note : Use Pragmas when possible !
  263.           If ANY Pragmas are used, but
  264.           the "ak_gen0.library" is used with the Stubs,
  265.           you may (will) get Gurus/Alerts !!! )
  266.      - new Include-File "ak_gen0_obsolete.h" with old definitions, etc.
  267.      - bug-fixes (not many, but nevertheless !)
  268.      - and more
  269.  
  270.  
  271.     [ Version-History of versions before V37 is no longer
  272.       included. ]
  273.  
  274.  
  275.     Copyrights :
  276.     ============
  277.  
  278.     Some of the mentioned names or products above may be copyrighted by
  279.     companies or trademarks of companies.
  280.  
  281.  
  282.